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1. INTRODUCTION 



The SDS 940 Dynamic Digital Debugging Tool (DDT) gives 
the user the capability of investigating a program's opera- 
tion in terms of its original symbols. Because of the high 
degree of man-machine interaction permitted and the avail- 
ability of the DDT subsystem, it allows the user to maintain 
vigilance over his program as it is executing. It also allows 
him to execute one, part, or all of his program's instruc- 
tions and to investigate, between executions, the contents 
of any or all variables or locations. 

A "patching" mechanism is provided for modifying programs 
and then continuing execution with negligible turn-around 
time. Other features of DDT include word pattern searches 
and execution halts at specified breakpoints. 

Significantly, only a small fraction of the computer's time 
is actually employed during on-line debugging. The 940 
Executive dismisses programs that are awaiting input and 
moves them to secondary storage. When the user makes his 
next move, the program resumes operation, usual ly within 
a second or two. 

In addition to its on-line debugging capabilities, DDT 
allows the user to write machine- language programs di- 
rectly. Although DDT does not save symbolics, dump 
files of programs can be created, so that many sessions 
of debugging can take place without the symbolics ever 
being reassembled. 

This manual is intended to serve as a tutorial guide for the 
new DDT user and as a reference source for the experienced 
user. For clarity, several typographic conventions are used 
throughout the manual. These are explained below. 

1. Underscored copy in an example represents that produced 
by the system in control of the computer. Unless other- 
wise indicated, nonunderscored copy in an example is 
that typed by the user. 

2. The notation © signifies a carriage return and 
signifies a line feed. The user signals the end of a 
DDT command by striking the RETURN key, and the 
system confirms the command with an automatic line 
feed. If either or both of these functions are initiated 
by the system, no notation is used. 

3. Where the symbol "o" appears in a DDT command, it 
represents a "blank" character. 

OPERATING PROCEDURES 



LOGIN 

To gain access to the computer, the following operating 
sequence is performed: 

1 . If the FD-HD (Full Duplex-Half Duplex) switch is pres- 
ent, turn the switch to FD. Thisisatoggle switch with 
two locking positions. When the Teletype is not con- 
nected to the computer (sometimes cal led the Local Mode), 
this switch must be in the HD position. Whenever the 
Teletype is connected to the computer, this switch must 
be in the FD position. 

2. Press the ORIG (originate) key, which is usually lo- 
cated at the lower right corner of the console directly 
under the telephone dial. This key is depressed to ob- 
tain a dial tone before dialing the computer center. 

3. Dial the computer center number. When the computer 
accepts your call, the ringing will change to a high- 
pitched tone. There will then appear on the Teletype 
a request that the user log in: 

PLEASE LOG IN! 

4. The user must then type his account number, password, 
and name in the following format: 

number password; name © 

Only persons who know all three elemenfs(the account 
number, password, and name) may log in under that 
particular combination. The following examples all 
illustrate acceptable practice. 

PLEASE LOG IN! 123PASS;JONES © 

PLEASE LOGIN! 151WORD;BROWN © 

PLEASE LOG IN! 175PW;PSEUDO © 

If the account number, password, and name are not 
recognized by the computer, it will print INVALID 
USER. The log-in procedure must then be repeated. 
If the user does not type his account number, password, 
and name within a minute and a half, a message is 
transmitted instructing him to call the computer center 
for assistance. The computer will then disconnect the 
user, and the dial and log-in procedure will have to be 
repeated. 

5. If the account number, password, and name are ac- 
cepted by the computer, it will print READY, the date, 
and the time on the next line, and a dash at the begin- 
ning of the following line: 

READY date, time 



The standard procedure for gaining access to an SDS 940 time- 
sharing computer center from a remote Teletype terminal is 
described in the SDS 940 Terminal User's Guide, Publica- 
tion No. 90 1 1 18. The user should also have a general 
understanding of the TAP macro assembler described in the 
SDS TAP Reference Manual, Publication No. 90 II 17. The 
following paragraphs summarize the standard procedures as 
they apply to DDT users. 



The dash indicates that the 940 Executive is ready to 
accept a command. 



In some 940 time-sharing systems the commercial"at" sign, 
@, is used to indicate that the 940 Executive is ready to 
accept a command. 



Introduction 



6. In response to the dash, the user types 

DDT 

When ready to accept commands, DDT responds with 
a carriage return and line feed, but does not print a 
confirming symbol. 

ESCAPE 

The ESCAPE © key may be used at almost any time. It 
causes the DDT subsystem to abort the current operation and 
ask for a new command. Striking the key before termin- 
ating a command with © aborts the command. 



In some 940 time-sharing system configurations the RUB- 
OUT or ALT MODE key is used instead of the ESCAPE key. 
Where © appears in this manual, RUBOUT or ALT MODE 
may be substituted. 



EXIT AND CONTINUE 

Striking the © key twice in succession causes computer con- 
trol to return to the Executive. The user may reenter DDT 
with program and execution status intact by typing 

-CONTINUE © 

The system then prints a "DDT", to confirm the action, and 
returns control to DDT. 

LOG OUT 

When the user wishes to be disconnected from the computer, 
he types two consecutive escapes (to return control to the 
Executive) and then types 

LOGOUT 

The computer will respond by printing the amount of com- 
puter time and hook-up (line) time charged to the user's 
account since the previous log-in procedure was completed. 



2. DOT'S LANGUAGE 



The language available to DDT users consists of constants, 
symbols, expressions, and commands. 

CONSTANTS 

A constant is any string of digits which may be followed by 
a B or D to signify an octal or decimal number, respectively. 
The number represented by the constant is evaluated and 
truncated to 24 bits. The base or radix for numbers is nor- 
mally eight (octal), but the base may be changed by a DDT 
command. Constants are always accepted and printed by 
DDT in the current radix. However, if a constant is termi- 
nated by B or D, it is interpreted as octal or decimal re- 
gardless of the current radix. 



Octal Constants 


Decimal Constants 


105B 

77777777 (where radix is 8) 


982D 

46890 (where radix is 10) 



SYMBOLS 

A symbol is any legal string of letters and numerals con- 
taining at least one letter. In symbols of more than six 
characters only the first six are significant; thus, "ALPHA- 
BET" is equivalent to "ALPHAB". TAP instruction mne- 
monics are legal DDT symbols. 



Legal Symbols 


Illegal Symbols 


ABC 

AB124 

12XYZ 


135B 
AB*CD 



Note that "135B" is not a legal symbol but rather an octal 
constant; "AB*CD" is not a legal symbol because " *" is 
neither a letter nor a numeral. 



EXPRESSIONS 

A DDT expression is a string of numbers or symbols connected 
with blanks or any of the operators shown below. These op- 
erators have the following significance: 



+ addition 

subtraction 

* (integer) multiplication 

/ (integer) division 

& logical AND 

< less than 

= equals 

> greater than 



Expressions are always evaluated from left to right. All 
operators have the same precedence and parentheses are not 
allowed. The first symbol or number may be preceded by a 
minus sign. A blank is equivalent to a plus sign, except 
that the operand that follows is truncated to 14 bits be- 
fore being added to the accumulated value of the ex- 
pression. 

The value of an expression is an 8— digit octal integer. An 
expression may be a single symbol or a constant. 



DDT's Language 



Examples: 



Expressions 


Octal Value 


10D+20D 


00000036 


5-2 


00000003 


LDA 


07600000 


LDA+10 


07600010 


LDA 10 


07600010 


SYM 


00001212 (previously defined) 


SYM 10 


00001 222 


LDA SYM 


07601212 



COMMANDS 

A command is an order typed by the user instructing 
DDT to perform a function. Commands in DDT generally 
take the form 



e;c 



where e is an expression and c is a character. 

A question mark (?) may be typed at any time to abort the 
current command. 



3. COMMANDS CONCERNING THE RADIX 



As mentioned previously, all expressions are evaluated ac- 
cording to the current base or radix. DDT normally calcu- 
lates expression values using base 8. To alter the current 
radix the user may type one of the commands listed below. 



Command 


Purpose 


e;R 


Sets the radix to 3, where e must 




be greater than 1 . 


;D 


Sets radix to 10. All expressions 




will be calculated and printed in 




base 10. 


;0 


Sets radix to 8. All expressions 




will be calculated in base 8. 



Until the radix is changed, all subsequent expressions are 
evaluated in the specified radix. 

Example: 



-DDT 

2;R 

111 + 101 = 1100 

11111+1 = 100000 

5;R 

1 234 + 1 = 1240 

Note that an equals sign following an expression causes 
DDT to evaluate the expression and print the answer in a 
constant form. 



The following is an example of expression evaluation using 
octal and decimal radixes. 

Example: 



;0 




56+44 


= 122 © 


32-11 


= 21 © 


34;*56 


= 2410© 


12;/2 


= 5. © 


= 5 




;D 




56+44 


= 100© 


32-11 


= 21© 


34;*56 


= 1904© 


12;/2 


= 6© 


= 6 





Note that if only the equals sign is typed, the value of the 
last expression typed is printed. The last expression typed 
may be referred to as ;Q. 



Example: 



;D 

1000+986 

;Q 

;Q+4 



1986 © 
1986 © 
1990© 



Commands Concerning the Radix 



4. COMMANDS TO EVALUATE EXPRESSIONS 



In addition to the equals sign, there are other commands 
that cause DDT to evaluate and print the value of an ex- 
pression. These commands are listed below. 



Examples: 



Command 


Purpose 


# 

■ 

(a) 

@ = 


Types the value of ;Q as a signed 
integer. 

Types the value of ;Q in symbolic 
form. 

Types the value of ;Q as text. 

Types the address part of ;Q in 
symbolic form. 

Types the value of ;Q as a numeric 
operation code. 



77777777 # 


jlL® 


1 2345670 # 


12345670 


40000000 # 


40000000 © 


76000000 — 


WIO 0,2 © 


07600000 — 


LDA © 


07500010 — 


LDB 10© 


41' 


A © 


10220043' 


A@C© 


144@= 


14400000© 



5. MEMORY ALLOCATION 



Upon entering DDT, the user does not have memory auto- 
matically allocated to him. DDT obtains program memory 
only when (1) it is required for loading a binary file, (2) 
the execute command (;U) is given and a new page is 
needed to hold the instruction to be executed, and (3) a 
reference is made to a memory location that is not in a 
page previously obtained. 

If another subsystem was being used prior to entering DDT, 
the user may still have some pages of memory assigned to 
him. In this case, he should release all previous memory 
by issuing the Executive command, CLEAR. 

Examples: 

(1) -DDT© 
CAX;U 

(2) -DDT© 
LDA 4000;U 

In example 1, the command ;U causes the instruction 
CAX (04600400) to be loaded in location 240g; DDT obtains 
the core page containing this location, which is page zero 
(all locations between 240g and 3777 g). 



In example 2, the ;U command used in conjunction with 
LDA 4000 will cause DDT to obtain two pages of memory; 
the first to hold the instruction and the second because it 
contains the location 4000g referred to by the command. 

Note that if DDT has already obtained some memory when 
the ;U command is issued, the instruction to be executed is 
loaded into the first unused memory location. "Unused 
memory" refers to memory that has been defined. The first 
unused memory location is usually referred to as ;F. Only 
if there is no unused memory beyond ;F will a new page be 
obtained. DDT always loads two BRS 10 instructions follow- 
ing the instruction to be executed. 

The user may also use the backward slash \ (shift L) to ob- 
tain memory and enter data. 

Example: 



-DDT © 
240\ LDA 



4000 



RESET in 940 RAD/Tape Systems 



This sequence causes only one page of memory to be ob- 
tained(i.e., page zero, which holds the instruction). Note 
that the page containing location 4000 is not obtained until 
the instruction is executed. 



4 Commands to Evaluate Expressions/Memory Allocation 



6. OPENING REGISTERS 



A major feature in the DDT language is the "opened regis- 
ter". A register (core location) may be opened at any time 
and its contents printed for examination and possible alter- 
ation. However, the page in which the location exists 
must have been obtained by DDT prior to opening the 
register. 

To open a register, the user types the address and a slash. 
DDT responds by printing the contents of the location and 
issuing a tab. At this point the user may close the register 
without disturbing its contents, by striking a carriage re- 
turn. However, if he wants to change the contents, he may 
type whatever he wishes at the tab stop, followed by a 
carriage return. The new information will then be stored 
in the opened register. 

Example: 



Example: 



-DDT© 




NOP;U © 


240/ 


NOP © 


241/ 


BRS 12 


242/ 


BRS 12 


243/ 


0© 


244/ 


0© 


4000/ 


?© 



CLA © 



The slash can be used repeatedly to examine the contents 
of. the contents of the contents, ad infinitum, oftheopened 
register. If at any time during this procedure an expression 
is typed, that expression is stored in the original opened 
register. 

Example: 



-DDT© 
NOP;U© 
240/ NOP 

300/ 

240/ 300 



300© 
400© 



400 



© 



The other methods of opening a register are the line feed 
and the upward arrow. The line feed will open the regis- 
ter that follows the last one opened. A dot (typed as a 
period) always refers to the currently open register. There- 
fore, the line feed opens the .+ 1 register. Similarly, the 
upward arrow will open the register immediately preceding 
the last one opened; i.e., .-1 . 



-DDT 




240 


NOP© 


241/ 


BRS 12© 


.=241 


© 


242/ 


BRS 12 f 


241/ 


BRS 12 f 


240/ 


NOP© 


1 00+60= 


160© 


© 




241/ 


BRS 12 © 



Note that the request for the value of the expression 100+60 
does not make DDT "forget" which location was inspected 
last. 

Another command available is semicolon blank (;Q ). This 
is equivalent to a line feed except that nothing is printed. 
Its main use is in entering programs or data. 

Example: 

1000\ l;o2;a3© 

is equivalent to 

1000\ 1 © 

1001\ 2 © 

1002\ 3 © 

Using the information covered so far, the user can enter a 
program and data into DDT by (1) instructing DDT to obtain 
memory and (2) opening the registers needed and altering 
their contents 

Example: 



-DDT © 








CLA;U 








300; F 








240/ 


CLA 


LDX 


= 1000© 


241/ 


BRS 12 


LDA 


0, 2® 


242/ 


BRS 12 


ADD 


1, 2© 


243/ 





STA 


2, 2© 



Note that literals and tag references are recognized by DDT 
just as they are by TAP. This is also true for "*" f which 
indicates indirect addressing. 



Opening Registers 



7. COMMANDS CONCERNING MODES 



When the user enters DDT, the general mode is symbolic. 
Thus, if a register is opened with the slash, the contents 
will be printed in symbolic form. However, the user can 
change the current mode by issuing one of the commands 
listed in the table below. DDT will then print the contents 
of a register in the mode most recently set. 



Examples: 



Command 


Purpose 


;i 


Sets the current mode to "symbolic". 


;c 


Sets the current mode to "constant". 


;$ 


Sets the current mode to "signed 




integer" . 


.11 


Sets the current mode to "ASCII". 



Example: 

240/ 

;c 
240/ 

;: 
240/ 

;$ 

240/ 

.ii 

240/ 



LDA SYM © 

7600456© 
LDA SYM © 

7600456 © 
?!N© 



Although a mode is established by one of the above com- 
mands, the contents of a particular location may be printed 
in another mode by using one of the following commands: 



Command 


Purpose 


e] 


Opens location e and prints contents 




in symbolic form. 


ec 


Opens location e and prints contents 




as a constant. 


e$ 


Opens location e and prints contents 




as a signed integer. 


e" 


Opens location e and prints contents 




in ASCII (control characters are 




preceded by &). 


e\ 


Opens location e and does not print 




the contents. 



-DDT © 

NOP;U 

240/ 

2403 

240: 

240$ 

240" 

240\ 



NOP 
ADM 



ADM 
SYM © 



SYM© 



6300456 © 
6300456 © 
9_LN© 



If a location is opened by using one of these five commands, 
a subsequent line feed or upward arrow will cause the con- 
tents of the register thus opened to be printed in the specified 
mode rather than in the general mode. 

Example: 



;c 




240" 


ABC © 


241" 


DEF © 


242" 


GHI 



In this example, the general mode is the "constant" mode, 
but the contents of locations 240, 241, and 242 are printed 
in ASCII. 

The user can also control the form in which the address of a 
location is printed when it is generated by an expression, 
line feed, or upward arrow. The commands are as follows: 



Command 


Purpose 


;R 
;V 


Address will be printed in the rela- 
tive mode. 

Address will be printed ; n the abso- 
lute mode. 



Examples: 



;R 




240/ 


LDX ADR+5 © 


MSI/ 


LDB0,2© 


MS1+1/ 


LSH 10 to 


MS 1+2/ 


STA X © 


MS 1+3/ 


SKE COLON (^ 


;V 

240/ 


LDX 304 © 


241/ 


LDB0,2 © 


242/ 


LSH 10 (?) 



243/ 
244/ 
245/ 
246/ 



STA 273 © 
SKE 274 © 
BRU 247 © 



© 



Commands Concerning Modes 



8. INDIRECT ADDRESSING 



DDT provides a command for addressing a location indi- 
rectly. To open the location whose address is the last 
14 bits of the value of the last expression typed, the 
user types a left parenthesis. 

Example: 



-DDT© 

240\ LDA 
400\ 1234 



400 © 



240/ 
l 


LDA 


400 © 


400/ 
400/ 


1234 
5678 


5678 © 



If another slash had been typed following the 5678 typed 
by the user, any expression following the slash would have 
been stored in the location that was opened first (in this 
case, location 400). 



9. CENTRAL REGISTERS 



Because time-sharing requires that several simultaneous 
users share the computer's central registers, the contents 
of the central registers are assigned as the values of 
special symbols. Thus, to interrogate the contents of 
the central registers, the user has available the follow- 
ing commands: 



Command 


Purpose 


;A= 


Prints the contents of the A register 


;B= 


Prints the contents of the B register 


;X= 


Prints the contents of the X register 


;L= 


Prints the contents of the location 




counter 



Other appropriate commands (see "Commands to Evaluate 
Expressions", above) may be used with these symbols in- 
stead of the equals sign. 



Example: 

;A= 
B= 
X" 
L= 



0. 
1 

ABC 
280 



The following commands are available to alter the contents 
of the central registers. 



Command 


Purpose 


e;A 


Stores the value of e in the A register 


e;B 


Stores the value of e in the B register 


e;X 


Stores the value of e in the X register 


e;L 


Stores the value of e in the location 




counter 



ixample: 



5;A 

;A=5© 



Indirect Addressing/Central Registers 



10. SYMBOL DEFINITION 



A symbol may be defined by using a DDT command, or it 
may enter DDT predefined (via the symbol table that ac- 
companies an object program). 

To define a symbol by using a DDT command, the user may 
type 

e<s> 

where e is any expression and s is any legal symbol. This 
will cause DDT to assign the value of the expression to the 
symbol. 

Example: 



400<DATA1> 
DATA1/ 0. 1 © 
DATA1/ J_© 

The first line of the example assigns DATAl to location 
400. The second line puts a "1" in location 400. 



Similarly, typing a symbol followed by a colon will assign 
the current location (the address of the opened register) as 
the value of the symbol. 

Example: 



500© 



The use of the "@' sign following a symbol will cause the 
last expression printed by DDT or typed by the user to be 
assigned as the value of that symbol. 

Example: 



-DDT 




240\ START: 


LDA 


START-240 © 




START/ LDA 


500 



-DDT 

400\ 



400/ 

BEGN= 

777/ 



777 © 

777 

777® 

CAX© 



BEGN@ CAX © 



11. ERASING SYMBOLS 



The user can "undefine" a symbol by using the kill (;K) 
command. If the ";K" is preceded by a symbol, just 
that symbol is "killed"; ";K" alone will kill all defined 
symbols. The use of ";K" causes the computer to print 
"OK" and wait for a carriage return. This prevents in- 
advertent erasures. 

The command ";U" will cause all undefined symbols to be 
listed on the Teletype. 



The following example illustrates the use of the kill 
command. 



Example: 



-DDT 

NOP;U 

240/ 0. START: © 

500/ 0. ITEMNO: © 

START=240 © 

ITEMN 0=500© 

START;K 

ITEMN 0=500© 

START=2® 

;K - - OK © 

ITEMNO= ?© 

START=? 



8 Symbol Definition/Erasing Symbols 



12. BLOCK STRUCTURE 



A limited facility called the "block structure" is provided 
to simplify referencing local symbols that are defined in 
more than one program. The block structure of a program 
is organized in the following manner: Every binary program 
file loaded by DDT constitutes a separate block. Also, 
there is an intrinsic block called"block zero". Anysymbol 
input to DDT has a block number associated with it. It also 
has a type: (1) external (global) or (2) local. 

All instruction mnemonics are associated with block zero 
and are external. When a binary file written by TAP is 
loaded by DDT, it defines a new block; all symbols defined 
during the assembly and written on the binary file are asso- 
ciated with that block. Any symbols that were declared by 
TAP to be external are external symbols . All other symbols 
are local symbols. 

External symbols must be unique within an entire program, 
since they are recognized at all times. Local symbols are 
recognized according to the following rules: 

1 . At any given time, there is one block that is called 
the primary block. A block becomes the primary block 
when one of its registers is opened. All other blocks 



are secondary. All symbols associated with the primary 
block will be recognized. 

2. If a symbol is used which is neither external nor in the 
primary block, the entire symbol table is scanned for it. 
If it occurs in only one block, that block becomes pri- 
mary and the symbol is recognized properly. If it occurs 
in more than one block, an error is indicated. 

3. A symbol may be explicitly qualified by 

s l &s 2 

where Si is the name of the block (the name appearing 
in the label field of the IDENT statement in TAP) and 
s~ is the symbol in question. 

Symbols defined by the"@"or":" commands are local to the 
block that is primary when the command is given. Symbols 
defined by "<>" are external and not local to any block. 
Not all symbols appearing in a block will necessarily be 
local to that block. 



To obtain a listing of all block names, the user may type 
"%&". 



Block Structure 



13. WORD SEARCH 



DDT gives the user the capability of searching memory, be- 
tween any given limits, for a specified word. Also, a mask 
may be specified to determine which bits of the word are to 
be compared. The commands used are listed below. 



Part II 



240,255; L 



Command 


Purpose 


e;M 


Mask — sets the mask to the value of e. 


e;l 


Lower bound — sets the lower bound to 
the value of e. 


e;2 


Upper bound — sets the upper bound to 
the value of e. 


^ 1 ' 9' 


An alternative command to set lower 
(e.) and upper (e„) bounds. 


e;W 


Word search — searches memory between 
limits ;1 and ;2 for locations which 
match e when both are masked by the 
value of ;M. All matching words are 
printed. 


e;E 


Effective word search —searches mem- 
ory between limits ;1 and ;2 for effec- 
tive address equal to e. 


e J 


Not-word search — same as e;W except 
that all words not matching e are printed. 



The following two examples illustrate the word search com- 
mands. In both examples the information in Part I repre- 
sents a DDT listing of a program segment; the information in 
Part II illustrates various word search operations by the user. 

Example A 



Part I 




240/ 


LDX 304 © 


241/ 


LDB 0,2 © 


242/ 


LSH 10© 


243/ 


STA 273 © 


244/ 


SKE 274© 


245/ 


BRU 247 © 


246/ 


BRU 270 © 


247/ 


TCO 273© 


250/ 


CLA© 


251/ 


LSH 10© 


252/ 


STA 273© 


253/ 


SKE 274© 


254/ 


BRU 256© 


255/ 


BRU 270 © 


256/ 


TCO 273© 


257/ 


CLA © 


260/ 


LSH 10 ® 



CLA;W 
250/ 


CLA 




777; M 






273;W 
243/ 
247/ 
252/ 


STA 

TCO 

STA 


273 
273 
273 



Example B 



Part I 




MSG/ 


LDX ADR+5 © 


MSI/ 


LDB 0,2 © 


MS1+1/ 


LSH 10© 


MS 1+2/ 


STA X © 


MS 1+3/ 


SKE COLON© 


MS 1+4/ 


BRU MS1+6© 


MSI +5/ 


BRU MS2 © 


MSI +6/ 


TCO X© 


MSI +7/ 


CLA© 


MS1+10/ 


LSH 10© 


MS1+11/ 


STA X © 


MSI +12/ 


SKE COLON © 


MS1+13/ 


BRU MS1+15 © 


MSI +14/ 


BRU MS2 © 


MS1+15/ 


TCO X © 


MS1 + 16/ 


CLA © 


MS1+17/ 


LSH 10© 


MS 1+20/ 


STA X © 


MS1+21/ 


SKE COLON© 


MSI +22/ 


BRU MSI +24© 


MSI +23/ 


BRU MS2 © 


MSI +24/ 


TCO X© 


MSI +25/ 


EAX 1,2 © 


MSI +26/ 


BRU MSI© 


MS2/ 


TCO LF© 


MS2+1/ 


TCO CR© 


MS2+2/ 


BRS 12© 


x/ 


© 


COLON/ 


32© 


LF/ 


152© 


CR/ 


155© 


Part II 




MSG;1 




X;2 




COLON ; E 




MSI +3/ 


SKE COLON 


MS1+12/ 


SKE COLON 


MS1+21/ 


SKE COLON 



10 



Word Search 



14. PROGRAM ALTERATION 



In debugging a program, it is often necessary to insert or 
delete instructions. In DDT this can be done easily with- 
out reassembling the program. 

INSERTIONS 

To insert instructions (a procedure often referred to as patch- 
ing), the user issues one of the commands listed in the table 
below. In response, DDT issues a carriage return and line 
feed, prints a right parenthesis, and waits for the user to 
type the insertion. 



Command 


Purpose 


e;I 


Causes instructions to be inserted after lo- 




cation e. 


e) 


Causes instructions to be inserted before lo- 




cation e. 



After one of the patch commands has been issued, legal In- 
put consists of a series of expressions whose values are 
inserted in successive locations in memory. Each of these 
expressions should be terminated by a line feed or ; □, 
exactlyas though the programwere being typed in with the 
"\" command instead of as a patch. Two other commands 
are legal in the patch mode: 

1. ' The colon, which maybe used to define a local symbol 

with a value equal to the current location. 

2. The carriage return, which terminates the patch. 

The e) patch command followed by the instructions to be 
inserted will cause the following sequence to occur. 

1. The instructions to be inserted are loaded sequentially 
beginning with ;F (;F being the first unused memory 
location). 

2. Location ;F is updated. 

3. The instruction at the point of insertion is then copied 
into location ;F. 

4. Location ;F is updated. 

5. Two return branches are loaded into the new ;F and 
;F+1 so that, if the patch is a skip instruction, the 
program will operate correctly. 

6. Location ;F is updated. 



Example: 










Before 


After 


250/ LDA 
251/ STA 


Al 
A2 


250/ 
251/ 


LDA 
BRU 


Al 
1000 



;F=1000 


1000/ 


ETR 


=77 




1001/ 
1002/ 


STA 
BRU 


A2 
252 


. 


1003/ 


BRU 


253 


251) 








)ETR =77 









The command ";I" would cause the new instructions (see ex- 
ample above) to be inserted also, but STA A2 would appear 
in location 1000 rather than 1001. 

LITERALS 

As mentioned previously, literals have the same format and 
meaning in DDT as in the assembler; i.e., an equals sign 
following a blank signals the beginning of a literal that is 
terminated by any of the characters which ordinarily termi- 
nate an expression. In contrast to the syntax of the assem- 
bler, the expression in a DDT literal must be defined. 

The literal is looked up in the literal table. If it does not 
appear in the table, it is stored in the current ;F location 
and ;F is increased by 1. For example, if the literal -1 does 
not already exist in the literal table and ;F is 1000B, 
then "LDA = -1" causes a -1 to be stored at 1000B. Then, 
the instruction is equivalent to "LDA 1000B", and the 
new value of ;F is 1001 B; however, in the patch mode, 
literals are saved and are not stored until the patch is 
completed. Otherwise, they would interfere with the patch. 



DELETIONS 

To delete instructions, using DDT, the user may open a reg- 
ister and replace its contents by a NOP instruction. 

Example: 



240/ 


LDA 


Z © 


241/ 


CLB 


NOP © 


242/ 


LSH 


6 NOP © 


243/ 


STA 


Z+l © 



PSEUDO RELABELING f 



Command 


Purpose 


e^ e^;R 


Sets pseudo relabeling for a program 
according to the value of e, and e„. 



See SDS 940 Time-Sharing System Reference Manual. 
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15. PROGRAM EXECUTION 



Program execution is of primary importance to the DDT 
user. Therefore, DDT provides the user with sophisticated 
execution capabilities. For example, the user may start 
and stop program execution at any given address. Also, 
he may execute one instruction at a time or N instruc- 
tions at a time. He can list up to four breakpoints, or 
he can specify how many times to pass a breakpoint be- 
fore stopping. 

BREAKPOINTS 

The term "breakpoint" simply means "the address at which 
program execution is to stop". The break always occurs 
before the execution of the instruction at the breakpoint 
location. DDT then prints this address and the contents of 
the central registers A, B, and X. DDT has four break- 
points which can be set simultaneously. They are numbered 
0-3. The commands to specify, set, clear, or list break- 
points are listed below. 



Command 


Purpose 


e! 


Sets breakpoint at the address e. 




n;e! 


Sets breakpoint n (where < n < 3) 
address e. 

Clears all breakpoints. 


at the 


.1 


Lists all breakpoints. 




n;l 


Clears breakpoint n. 





EXECUTION COMMANDS 

To control execution, the following commandsareavai lable: 



Command 


Purpose 


e;G 


Starts execution at location e. 


;P 


Restarts execution at the value of the lo- 




cation counter (;L). 


e;P (when 


Restarts execution at ;L and breaks after 


e is an 


e breakpoints have been reached. 


integer) 




;N 


Executes the next instruction and then 




breaks. 


e;N (when 


Executes e instructions and breaks. 


e is an 




integer) 




e;S 


Executes the next instruction, breaks, and 




repeats this sequence e times. 



The following example demonstrates the use of the above 
commands in a typical debugging session. The program to 
be debugged is a message printer. 

Part I is a DDT listing of the program. Part II is the debug- 
ging and execution of the program. 

Note that in Part lithe first three characters of the message 
appear on lines labeled 1,2, and 3. The remaining charac- 
ters of the message, plus some extraneous characters, appear 
on line 4. 

By reexecuting the program, it is discovered that a CLA in- 
struction is missing at the beginning of the program. Line 5 
inserts the missing instruction and line 6 changes the address 
of the BRU inMSG+26 so that the CLA instruction is included 
in the loop. 

Example: 
Part I 



MSG/ 


LDX ADR+5© 


MSI/ 


LDB 0,2 © 


MS1+1/ 


LSH 10© 


MS 1+2/ 


STA X© 


MSI +3/ 


SKE COLON © 


MSI +4/ 


BRU MS 1+6© 


MSI +5/ 


BRU MS2 © 


MSI +6/ 


TCO X © 


MSI +7/ 


CLA© 


MS1 + 10/ 


LSH 10© 


MS1 + 11/ 


STA X © 


MS1+12/ 


SKE COLON© 


MSI +13/ 


BRU MS1+15© 


MS1+14/ 


BRU MS2 © 


MS1 + 15/ 


TCO X© 


MSI +16/ 


CLA© 


MS1 + 17/ 


LSH 10© 


MSI +20/ 


STA X© 


MS1+21/ 


SKE COLON© 


MSI +22/ 


BRU MS 1+24© 


MSI +23/ 


BRU MS2© 


MS 1+24/ 


TCO X© 


MS 1+25/ 


EAX 1,2 © 


MSI +26/ 


BRU MSI © 


MS2/ 


TCO LF© 


MS2+1/ 


TCO CR© 


MS2+2/ 


BRS 12© 


x/ 


0© 


COLON/ 


32© 


LF/ 


152© 


CR/ 


155© 


ADR/ 


102(a) 21043 ' ABC© 


ADR+1/ 


110@22446 ' DEF © 


ADR+2/ 


116@ 24051 ' GHI © 


ADR+3/ 


124@25454 ' JKL © 


ADR+4/ 


MUL ' : & 


ADR+5/ 


ADR © 


ADR+6/ 


© 
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Example: 





Part II 










;c 

MS 1+1! 










MSG;G 










MS 1+1 


11223000 


10221043 


277 




;N 










MS 1+2 


11400041 


10421400 


277 




;N 










MS 1+3 


11400041 


10421400 


277 




x/ 


11400041 








MS1+6! 










;P 










MS 1+6 


11400041 


10421400 


277 




;N 








(D- 


— -AMS1+7 
MSl+15! 

;P 
MSl+15 


11400041 


10421400 


277 




42 


1 0600000 


277 




;N 








0- 


— -BMSl+16 
MS 1+24! 

;P 

MS 1+24 

;N 


42 


10600000 


277 




43 


0_ 


277 


®- 


— -CMS1+25 
j 

;P 


43 





277 


©- 


— -DEFGHIJKL: © 
MS2! 
MSG;G 

ABC DEFGHIJKL: 
MS 1+25! 
MSG;G 


© 








ABC MS 1+25 

;P 
DEFMS1+25 

;P 

GH IMS 1+25 


43 





411 




46 





4J_3 




5] 





414 



©■ 



;P 








JKLMS1+25 


54 





415 


;N 








MSI +26 


54 





416 


;N 








MSI 


54 





416 


;N 








MS1+1 


54 


6400000 


416 


;N 








MS1+2 


26032 





416 


x/ 


54 






MSG;I 








) 


CLA 






ADR+5/ 


ADR © 






ADR+6/ 


LDX ADR+5© 




ADR+7/ 


CLA (£) 






MSI/ 


LDB 0,2 






MSG/ 


BRU ADR+6 © 




MSI +26/ 


BRU MSI 


BRU ADR+7 


MSG;G 








ABCDEFGHIJKL 









©- 



ADDITIONAL EXECUTION COMMANDS 

Four other commands are provided, to make the debugging 
process as simple as possible. These are listed below. 



Command 


Purpose 


e;0 (when e = 1) 


Causes POP's to be treated as one 




instruction for :N and :S. 


e;0 (when e = 0) 


Causes POP's to be treated as part 




of user's code. 


e;U (when e = 1) 


Causes subroutines to be treated as 




one instruction. 


e;U (when e = 0) 


Causes subroutines to be treated 




explicitly. 
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16. PANICS 



In conjunction with program execution, DDT recognizes 
four kinds of "panic" conditions. 

1. Illegal-instruction panics from the user's program. 

2. Memory-allocation-exceeded panics from the user's 
program. 

3. Panics generated by pushing the ESCAPE button. 

4. Panics generated by the execution of BRS 10 in the 
user's program. 

For the first two conditions, DDT prints out a message, the 
location of the instruction at which the panic occurred, 
and the contents of this location. These messages are as 
follows: 

1. 1 >> (Illegal instruction panic). 

2. M > > (Memory allocation exceeded). 

The other two types of panics cause DDT to ring the bell 
and issue a carriage return. Both ";L" and "." will be equal 
to the location at which the panic occurred. 



If a memory-allocation-exceeded panic is caused by a 
transfer to an illegal location, the contents of the location 
causing the panic are not avai lable. Therefore, DDT types 
a "?". 

Two other panic conditions are possible in DDT. 

1. If the ESCAPE button is pushed twice with no interven- 
ing typing by the user, control returns to the Executive. 

2. If the ESCAPE button is pushed while DDT is executing 
a command, execution and typeout are terminated. 
DDT issues a carriage return, rings the bell, and then 
awaits further commands. 

Moreover, attempts to proceed through certain instructions 
having to do with forks will produce erroneous results, and 
breakpoints encountered when the program is running in a 
fork will not perform properly. Attempts to proceed through 
unreasonable instructions will cause the error comment 

S>> 

to be typed. 



17. INPUT 



To execute and debug a program, using DDT, the object 
code of the program is usually located on a disc file pre- 
pared by TAP. TAP automatically writes a list of symbols 
along with binary object code that DDT can access. 

To instruct DDT to read and load the file containing the 
object code and symbol table, the user types 

;T /file/ (g) 

This will cause the relocatable program to be loaded, be- 
ginning at location 240g. After input has been completed, 
the first location not used by the program (;F) is printed on 
the Teletype. A subsequent ";T" command would cause load- 
ing to begin at this location. 

In the event that an alternative loading position is desired, 
the user may type 

e;T/file/© 

where e is any expression (evaluated in octal). The block 
is then loaded beginning with location e. 

In addition to the loading procedure, ";T" causes DDT to 
read the list of symbols prepared by TAP and to append this 



list to its own (which simply consists of the instruction mne- 
monics recognized by TAP). 

If the user wishes to have a program loaded by DDT but does 
not want the local symbols on the binary file added to the 
symbol table, he may use the command 

e;Y /file/© 

As before, if e is omitted, loading will begin with location 
24CL or the first location available. 



Example: 



-TAP 
BINARY 
OLD FILE 
INPUT 



45 

-DDT 
;T 

305 

;F = 305 



/BIN/ © 

/TEST/ © 

CELLS USED BY PROGRAM 

/BIN/ © 
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18. OUTPUT 



Commands are available that will cause symbols to be 
written on a specified file for permanent storage. These 
commands are listed below. 



Note that ";W" will also cause all IDENT labels to be 
printed. 



Command 


Purpose 


;W/file/ 
;C /file/ 


Causes all global symbols to be 
written on the specified file, in a 
format that can be read with ";T". 

Causes all symbols to be written 
on the specified file. 
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APPENDIX A. CHARACTER CODES 

SDS 940 INTERNAL, ASCII, TELETYPE, LINE PRINTER, AND CARD CODES 



INT 


ASCII 


TTY 


LP 


CARDS 


INT 


ASCII 


TTY 


LP 


CARDS 


00 


40 








40 


100 


@ 


v/ 


78 


01 


41 


i 


i 


-0 


41 


101 


A 


A 


+1 


02 


42 


u 


■ 


84 


42 


102 


B 


B 


+2 


03 


43 


# 


* 


+78 


43 


103 


C 


C 


+3 


04 


44 


$ 


$ 


-38 


44 


104 


D 


D 


+4 


05 


45 


% 


— -*s-~ 


085 


45 


105 


E 


E 


+5 


06 


46 


& 


A 


-78 


46 


106 


F 


F 


+6 


07 


47 


■ 


i 


84 


47 


107 


G 


G 


+7 


10 


50 


( 


( 


048 


50 


110 


H 


H 


+8 


11 


51 


) 


) 


+48 


51 


111 


I 


I 


+9 


12 


52 


* 


* 


-48 


52 


112 


J 


J 


-1 


13 


53 


+ 


+ 


+ 


53 


113 


K 


K 


-2 


14 


54 


/ 


/ 


038 


54 


114 


L 


L 


-3 


15 


55 


- 


- 


- 


55 


115 


M 


M 


-4 


16 


56 






+38 


56 


116 


N 


N 


-5 


17 


57 


/ 


/ 


01 


57 


117 


O 


O 


-6 


20 


60 











60 


120 


P 


P 


-7 


21 


61 


1 


1 


1 


61 


121 


Q 


Q 


-8 


22 


62 


2 


2 


2 


62 


122 


R 


R 


-9 


23 


63 


3 


3 


3 


63 


123 


S 


S 


02 


24 


64 


4 


4 


4 


64 


124 


T 


T 


03 


25 


65 


5 


5 


5 


65 


125 


U 


U 


04 


26 


66 


6 


6 


6 


66 


126 


V 


V 


05 


27 


67 


7 


7 


7 


67 


127 


W 


W 


06 


30 


70 


8 


8 


8 


70 


130 


X 


X 


07 


31 


71 


9 


9 


9 


71 


131 


Y 


Y 


08 


32 


72 


; 


: 


58 


72 


132 


Z 


Z 


09 


33 


73 


/ 


i 


-68 


73 


133 


c 


L 


+58 


34 


74 


< 


< 


+68 


74 


134 


\ 


\ 


068 


35 


75 


= 


= 


38 


75 


135 


D 


1 


-58 


36 


76 


> 


> 


68 


76 


136 


t 


=»= 


082 


37 


77 


? 


? 


+0 


77 


137 


— 


-Hf 


087 





SPECIAL CODES 


INTERNAL 


ASCII 


CONTROL 


141 


1 


A 


142 


2 


B 


143 


3 


C 


144 


4 


D 


145 


5 


E 


146 


6 


F 


147 


7 


G 


151 


11 


I 


152 


12 


J 


153 


13 


K 


154 


14 


L 


155 


15 


M 


161 


21 


Q 


162 


22 


R 


163 


23 


S 


164 


24 


T 


165 


25 


U 


166 


26 


V 


167 


27 


w 


170 


30 


X 


171 


31 


Y 


172 


32 


z 



FUNCTION 

SOM 

EOA 

EOM 

EOT 

WRU 

RU 

BELL 

TAB 

LINE FEED 

VT 

FORM 

RETURN 

X - ON 

TAPE 

X - OFF 

TAPE 

ESCAPE 

SPACE 
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APPENDIX B. SDS 940 INSTRUCTIONS 



MNEMONIC 

LOAD/STORE 

LDA 

STA 

LDB 

STB 

LDX 

STX 

EAX 

XMA 

ARITHMETIC 

ADD 

ADC 

ADM 

MIN 

SUB 

sue 

MUL 

DIV 

LOGICAL 

ETR 

MRG 

EOR 

REGISTER CHANGE 

CLA 

CLB 

CLAB 

CLX 

CLEAR 

CAB 

CBA 

XAB 

ABC 

BAC 

CAX 

CXA 

XXA 

CBX 

CXB 

XX B 

CNA 

BRANCH 

BRU 

BRX 

BRM 

BRR 

TEST/SKIP 

SKE 

SKG 

SKM 

SKA 

SKB 

SKN 

SKR 

SKD 



CODE 



76 


35 


75 


36 


71 


37 


77 


62 


55 


57 


63 


61 


54 


56 


64 


65 


14 


16 


17 


46 00001 


46 00002 


46 00003 


2 46 00000 


2 46 00003 


46 00004 


46 00010 


46 00014 


46 00005 


46 00012 


46 00400 


46 00200 


46 00600 


46 00020 


46 00040 


46 00060 


46 01000 


01 


41 


43 


51 


50 


73 


70 


72 


52 


53 


60 


74 



NAME 



Load A 

Store A 

Load B 

Store B 

Load Index 

Store Index 

Copy Effective Address into Index 

Exchange Memory and A 

Add 

Add with Carry 

Add to Memory 

Memory Increment 

Subtract 

Subtract with Carry 

Multiply 

Divide 

Extract (AND) 
Merge (OR) 
Exclusive OR 

Clear A 
Clear B 
Clear AB 
Clear Index 
C lear A, B, and Index 
Copy A into B 
Copy B into A 
Exchange A and B 
Copy A into B, Clear A 
Copy B into A, Clear B 
Copy A into Index 
Copy Index into A 
Exchange Index and A 
Copy B into Index 
Copy Index into B 
Exchange Index and B 
Copy Negative into A 

Branch Unconditionally 
Increment Index and Branch 
Mark Place and Branch 
Return Branch 

Skip if A Equals Memory 

Skip if A Greater Than Memory 

Skip if A Equals Memory on B Mask 

Skip if A and Memory do not Compare Ones 

Skip if B and Memory do not Compare Ones 

Skip if Memory Negative 

Reduce Memory; Skip if Negative 

Difference Exponents and Skip 
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MNEMONIC 


CODE 


NAME 


SHIFT 






RSH 


66 OOxxx 


Right Shift AB 


LRSH 


66 24xxx 


Logical Right Shift AB 


RCY 


66 20xxx 


Right Cycle AB 


LSH 


67 OOxxx 


Left Shift AB 


LCY 


67 20xxx 


Left Cycle AB 


NOD 


67 1 Oxxx 


Normalize and Decrement X 


CONTROL 






NOP 


20 


No Operation 


EXU 


23 


Execute 


INPUT/OUTPUT 






EOM 


02 


Energize Output M 


SKS 


40 


Skip if Signal Not Set 


PIN 


33 


Parallel Input 


POT 


13 


Parallel Output 


OVERFLOW 






OTO 


22 00100 


Overflow Indicator Test Onl 


REO 


22 00010 


Record Exponent Overflow 


ROV 


22 00001 


Reset Overflow Indicator 


OVT 


22 00101 


Overflow Indicator Test and 



APPENDIX C. SYSTEM PROGRAMMED OPERATORS 



MNEMONIC 



NUMBER 



FUNCTION 



BIO 

TCO 

TCI 

BRS 

CTRL 

SBRR 

SBRM 

STP 

LDP 

GCI 

WCH 

SKSE 

SKSG 

CIO 

WIO 

WCI 

FAD 

FSB 

FMP 

FDV 

EXS 

OST 

1ST 

DWO 

DWI 

DBO 

DBI 

ISC 

SIC 

GCD 

STI 

WCD 



176 
175 
174 
173 
172 
171 
170 
167 
166 
165 
164 
163 
162 
161 
160 
157 
156 
155 
154 
153 
152 
151 
150 
145 
144 
143 
142 
141 
140 
137 
136 
135 



Block input/output 

Teletype character output 

Teletype character input 

Branch to system 

Input/output control 

System branch and return 

System subroutine call 

Store pointer 

Load pointer 

Get character and increment 

Write character 

Skip on string equal 

Skip on string greater 

Character input/output 

Word input/output 

Write character and increment 

Floating add 

Floating subtract 

Floating multiply 

Floating divide 

Execute instruction in the system mode 

Output to specified Teletype 

Input from specified Teletype 

Disc word output (random) 

Disc word input (random) 

Disc block output (random) 

Disc block input (random) 

Internal to string conversion (floating output) 

String to internal conversion (floating input) 

Get character and decrement 

Simulate Teletype input 

Write character and decrement 
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APPENDIX D. DDT SUMMARY 



COMMANDS CONCERNING THE RADIX 



e;R 

;D 
;0 



Sets radix to e 
Sets radix to 10 
Sets radix to 8 



COMMANDS TO EVALUATE EXPRESSIONS 



OPENING REGISTERS 



e/ 



t 

Line Feed 

;a 



Types value of ;Q (where ;Q is the last expression typed) 

Types value of ;Q as a signed integer 

Types value of ;Q in symbolic 

Types value of ;Q as text 

Types the address part of ;Q in symbolic 

Types the value of ;Q as a numeric op code 



Opens location e and prints its contents in the current mode 
Opens preceding location and prints its contents 
Opens next location and prints contents 
Opens next location but does not print contents 



COMMANDS CONCERNING MODES 



en 
ec 
e$ 
e\ 

;R 
;V 



Sets current mode to "symbolic" 

Sets the current mode to "constant" 

Sets current mode to "signed integer" 

Sets current mode to "ASCII" 

Opens location e and prints contents in symbolic 

Opens location e and prints contents as a constant 

Opens location e and prints contents in ASCII 

Opens location e and does not print contents 

Prints address in relative mode 

Prints address in absolute mode 



INDIRECT ADDRESSING 



( Opens location whose address is the last 14 bits of the value of the last expression typed 

CENTRAL REGISTERS 



A = 

B = 

X = 

L = 
e;A 
e;B 
e;X 
e;L 

SYMBOLIC DEFINITION 

e<s> 

s: 

s@ 



Prints the contents of the A register 
Prints the contents of the B register 
Prints the contents of the X register 
Prints the contents of the Location Counter 
Stores the value of e in the A register 
Stores the value of e in the B register 
Stores the value of e in the X register 
Stores the value of e in the Location Counter 



Assigns the value of e as the value of the symbol 
Assigns the current location as the value of the symbol 
Assigns the value of ;Q as the value of the symbol 
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ERASING SYMBOLS 
s;K 

;K 
;U 

WORD SEARCH 

e;M 
e;1 
e;2 
ei/e 2 ;L 

e;W 

e;E 

e;# 

PROGRAM ALTERATION 



Ki 
Ki 
Lists a 



s symbol "s" 
s all symbols 



undefined symbols 



Sets the mask to the value of e 

Sets the lower bound to the value of e 

Sets the upper bound to the value of e 

Sets the lower bound to the value of ej and the upper bound to the value of ^2- 

Searches memory between lower and upper bounds for locations which match e when both 

are masked by the value of ;M 
Searches memory between lower and upper bounds for effective address equal to e 
Same as e;W except that all words not matching e are printed 



e;I 
e) 



Causes instructions to be inserted after location e 
Causes instructions to be inserted before location e 
Relabeling 



PROGRAM EXECUTION 

e! 

n;e! 
I 



n;! 
e;G 

;P 

e;P 

;N 

e;N 

e;S 

e;0 (when e= 1) 

e;0 (when e=0) 

e;U (when e= 1) 

e;U (when e=0) 

INPUT/OUTPUT 

;T /file/ 
e;T /file/ 
;Y /file/ 
e;Y /'file/ 
;V-' /file/ 
;C /file/ 



Sets breakpoint to the address e 

Sets breakpoint n (where n can be 0-3) to the address e 

Clears all breakpoints 

Lists all breakpoints 

Clears breakpoint n 

Starts execution at location e 

Restarts execution at the value of the location counter 

Restarts execution at ;L and breaks after e breakpoints have been reached 

Executes the next instruction and then breaks 

Executes e instructions and breaks 

Executes the next instruction, breaks, and repeats this sequence e times 

Causes POP's to be treated as one instruction for ;N and ;S 

Causes POP's to be treated as part of user's code 

Causes subroutines to be treated as one instruction 

Causes subroutines to be treated explicitly 



Loads binary file and symbol table beginning with location ;F 
Loads binary file and symbol table beginning with location e 
Loads binary file and external symbols beginning with location ;F 
Loads binary file and external symbols beginning with location e 
Causes all global symbols to be written on the specified file 
Causes all symbols to be written on the specified file 
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